home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / apps / 237 / doc_supp / stxfii.doc < prev   
Text File  |  1991-12-27  |  28KB  |  789 lines
  1.  
  2.  
  3.                     ST XFORMER II Short Documentation
  4.                     ---------------------------------
  5.                   This file must accompany STXFII.PRG!!
  6.  
  7.     This file is the short documentation included with ST Xformer II.  There
  8.     is online help in the program itself,  and registered users will be sent
  9.     the ST Xformer II Manual,  which explains all the topics covered here in
  10.     greater detail (with illustrations!).
  11.  
  12.  
  13.                           Contents of this file:
  14.                           ----------------------
  15.  
  16.          Part I    - Shareware and registration instructions    2
  17.          Part II   - Summary of Features                        4
  18.          Part III  - Changes from Xformer 1.2                   5
  19.          Part IV   - Atari 800/800XL/130XE emulation            6
  20.          Part V    - Apple and Commodore emulation              9
  21.          Part VI   - Updates and future versions               10
  22.          Part VII  - Invitation to 8 bit programmers           11
  23.          Part VIII - Closing comments                          12
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                  Page 1 
  64.  
  65.  
  66.  
  67.  
  68.                                   Part I
  69.                                   ______
  70.  
  71.     If  you're like me,  you probably get really ticked off when you  buy  a
  72.     piece  of  software and discover that it doesn't do what you  though  it
  73.     should  do,  or does it very badly.  Or,  as is the case with some  very
  74.     recent  software  that shall remain unnamed to protect those  guilty  of
  75.     producing it, the program is whipped together in a week and is more of a
  76.     beta release than a real usable product.
  77.  
  78.     Unfortunately,  with  the  "Buy First,  Suffer Later" attitude  of  some
  79.     dealers and fly-by-night software companies, there isn't much you can do
  80.     about  trying out the software before buying,  short of downloading  the
  81.     program from a pirate BBS.  And they wonder why piracy is so  widespread
  82.     on the ST!
  83.  
  84.     Realizing  this,  I decided that the best way to distribute  Xformer  II
  85.     would  be  as shareware and not as a  commercial  product.  This  solves
  86.     several problems.
  87.  
  88.     First,  the program is freely available nationwide on Atari BBSs and  on
  89.     information  services  like  Compuserve  and  GEnie.   That  means  that
  90.     obtaining  a copy is as easy as dialing your local BBS  and  downloading
  91.     it.  It can't be pirated, so pirate boards can only help to increase the
  92.     availability of the program.
  93.  
  94.     Second,  no  one  will get ticked off at blowing money  on  a  worthless
  95.     product,  since no money was spent.  This allows everyone interested  in
  96.     Xformer II to try it out first,  on their systems at home, and judge its
  97.     usefulness.
  98.  
  99.     Third,  those  people satisfied with Xformer can then send in their  $15
  100.     registration fee,  and receive the manual and updated software. For $15,
  101.     they  end up spending a lot less than they would have at a  dealer,  had
  102.     Xformer II been marketed in the usual way.
  103.  
  104.     Shareware  only  works  if users send in  their  registration  fees.  So
  105.     please,  if  you  end up using Xformer regularly,  it is  in  your  best
  106.     interest (and mine) to register.  You will receive an illustrated manual
  107.     (laser  printed  even!)  that guides you step by  step  through  all  of
  108.     Xformer's  features,  and contains tips on converting 8 bit software  to
  109.     run on the ST.  You will also get an up to the minute list of compatible
  110.     software.  I'll also send you a disk with the latest version of  Xformer
  111.     II.
  112.  
  113.     I  also recommend that you send me a 3 1/2" disk containing 8 bit  files
  114.     that you have ported over to the ST. I will look at these files and find
  115.     ones that work and place them on the compatibility list.  Programs  that
  116.     don't  work will be examined and either patched up to work,  or  Xformer
  117.     will be updated if necessary.  In any case, I'll send you your disk back
  118.     with 720K of the 8 bit software sent in from other users.
  119.  
  120.     Remember,  I've spent 2 years and 1000+ hours developing Xformer to  its
  121.     current  state.  This  is  more  time  than  is  spent  developing  some
  122.     commercial software,  and is certainly more time than is spent on  other
  123.     shareware  programs (asking even higher fees).  I'd like to  prove  that
  124.     shareware can and does work.  This might convince other software writers
  125.     to release their programs as shareware too.
  126.  
  127.  
  128.  
  129.                                  Page 2 
  130.  
  131.  
  132.  
  133.  
  134.     If  things  go well enough,  I'll set up a BBS for registered  users  to
  135.     automate the whole process of updates.
  136.  
  137.     So,  to become a registered user,  send $15 (U.S funds) or $20 (Canadian
  138.     dollars) to:
  139.  
  140.          Darek Mihocka
  141.          310-D Bluevale St. N.
  142.          Waterloo, Ontario  N2J 4G3
  143.          CANADA
  144.  
  145.     Please  include  your name and telephone number,  and  of  course,  your
  146.     address!
  147.  
  148.     My  voice number is (519)-747-0386.  Call it 24 hours a day,  7  days  a
  149.     week.  I won't be there most of the time,  but if I am, I'll answer your
  150.     questions.
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                  Page 3 
  196.  
  197.  
  198.  
  199.  
  200.                                  Part II
  201.                                  -------
  202.  
  203.     ST  Xformer II is a software emulator of the 6502 microprocessor.  On  a
  204.     standard ST,  running on a 68000 at 8 MHz, it executes roughly 80,000 to
  205.     100,000  instructions  per  second,  or about 40% the speed  of  a  6502
  206.     machine.  It hasn't been tested on any of the accelerator boards now out
  207.     for the ST.
  208.  
  209.     In  addition  to  the 6502 emulation,  3 hardware  emulation  modes  are
  210.     available:  Atari 800/XL/XE,  Apple ][,  and Commodore 64. NOTE: in this
  211.     release only the Atari emulation can be accessed.  Each of the  hardware
  212.     emulation modes is explained later.
  213.  
  214.     ST  Xformer  II is GEM based,  and runs on any color  or  monochrome  ST
  215.     system  with at least 1 Megabyte of memory.  It runs off floppy  or  the
  216.     hard disk.  It must be booted in either medium (80 column color) or high
  217.     (monochrome) resolution.
  218.  
  219.     If the program runs out of memory (800K is required) or it is booted  in
  220.     low  resolution,  an  error  message appears  and  the  program  exists.
  221.     Therefore,  if  you  only have a 1 Meg machine,  make  sure  all  memory
  222.     intensive desk accessories and AUTO boot programs are disabled.
  223.  
  224.     Xformer works on 1040 ROMs, Mega ROMs, and the "new" ROMs.
  225.  
  226.     Online help can be accessed from the menu bar under the "Help" entry. It
  227.     very briefly summarizes the most common procedures.
  228.  
  229.     Atari  800  support now includes DOS and non-DOS  disk  support,  Player
  230.     Missle Graphics,  emulation of most of the NMI and IRQ  interrupts,  and
  231.     emulation of most of the ANTIC, POKEY, and GTIA hardware registers. This
  232.     release has 2 promised features missing (hey,  this program took a _lot_
  233.     longer to write than planned): display list interrupt support, and XL/XE
  234.     bank select memory emulation.  Other less serious cosmetic problems  are
  235.     the  lack of GTIA support.  I simply ran out of colors registers on  the
  236.     ST.  These  bugs,  and  any others reported by users will  be  fixed  an
  237.     available on the update disk for registered users.
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                  Page 4 
  262.  
  263.  
  264.  
  265.  
  266.                                  Part III
  267.                                  --------
  268.  
  269.     Xformer  II  represents over 6 months of effort on my part to  take  the
  270.     various Xformer 1.x versions and join them into one unit.  Thus, Xformer
  271.     II replaces the Xformer 1.1 and 1.2 Atari 800 emulators, and the Xformer
  272.     1.0x Apple ][ emulator, which never really got released.
  273.  
  274.     The  user  interface  is totally redesigned.  Instead of  a  text  based
  275.     keyboard  entry  style interface,  Xformer II uses GEM for most  of  its
  276.     functions.   This  greatly  improves  usability,  which  was  one  major
  277.     complaint of the previous emulators.
  278.  
  279.     Xformer  II also runs twice as fast as the previous versions.  The  6502
  280.     emulator was rewritten to use a different p-code interpretter algorithm,
  281.     and all the assembly code was tightened up even more.
  282.  
  283.     Xformer II does away with all the extra files that were required for use
  284.     with previous versions.  The Atari ROMs are stored in STXFII.PRG itself,
  285.     and  DOS  emulation is handled differently,  as explained in  the  Atari
  286.     section.
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                  Page 5 
  328.  
  329.  
  330.  
  331.  
  332.                                  Part IV
  333.                                  -------
  334.  
  335.     Yep,  if  you're  still  reading this file,  you made it  to  the  Atari
  336.     emulation documentation. (yay! whopee!) You've still got pages to go!
  337.  
  338.     If  you currently use Xformer 1.1 or 1.2,  forget everything  you  know!
  339.     I've  redesigned everything.  STXFII.PRG now contains all the Atari  ROM
  340.     code  built in to it,  so you no longer need to rename files and do  all
  341.     the silly things I required you to do (he he).
  342.  
  343.     When  you boot the program,  click the Atari logo on the  title  screen.
  344.     Then  go up to the "Xformer II" menu entry and select the Atari  option.
  345.     An Atari Configuraton dialog box will appear.
  346.  
  347.     It  should  be  fairly self explanatory.  You can  select  either  Atari
  348.     400/800  ROMs (also known as ROM revision B) or the  XL/XE  ROMs,  which
  349.     give  you the faster text and graphics output,  and access  to  graphics
  350.     modes 12, 13, 14 and 15.
  351.  
  352.     Thanks  to Charles Marslett's fine work on the Fastchip floating  point,
  353.     and  with  his  permission,  you can select between  the  regular  Atari
  354.     floating point routines,  or his Fastchip routines,  which can  increase
  355.     the speed of math operations (and BASIC) by up to a factor of 3.
  356.  
  357.     Speaking  of  BASIC,  you can have it either IN or OUT.  Xformer  II  no
  358.     longer supports any other cartridges,  since no one ever indicated to me
  359.     that they used that feature. However, cartridges transfered to disk will
  360.     work. More on disk files in a few paragraphs.
  361.  
  362.     There is one rather cryptic option called "VBI Rate". This refers to how
  363.     often the emulator emulates vertical blank interrupts. The default is 1,
  364.     which means an Atari 800 VBI occurs every 1 ST vertical blank,  i.e.  60
  365.     times per seconds.  Similarly,  setting this option to 2 will give you a
  366.     60/2 = 30Hz VBI rate, and setting it to 3 sets it to 60/3 = 20Hz.
  367.  
  368.     WHY???????  (you  ask?) Simple.  The standard operating system  vertical
  369.     blank interrupts take up about 3 or 4% or the total processor time on an
  370.     Atari 800.  On the emulator though,  which still has to process the same
  371.     number of VBI's each second, (but does it at a slower speed), about 15 -
  372.     20% of the time is spent servicing the interrupts.  This slows down most
  373.     programs by 15 or 20%. Therefore Atari BASIC appears to run at about 30%
  374.     the normal speed. To fix this, I added the option so that you can reduce
  375.     the number of VBI's,  and give more processor time back to programs like
  376.     BASIC.  Try it at a setting of 3.  BASIC now speeds up to over 35%. Kill
  377.     vertical blanks all together (with a POKE 54286,0) and the emulator  now
  378.     runs at over 40% speed.
  379.  
  380.     Now, the disk support. Read this CAREFULLY!!
  381.  
  382.     On a regular 5 1/4" single sided single density floppy  disk,  formatted
  383.     on an 810 disk drive,  you will get 90K of storage.  This is derived  by
  384.     taking the number of tracks (40),  the number of sectors per track  (18)
  385.     and the number of bytes per sector (128) to give a total of 40*18*128  =
  386.     92160 = 90K.  Unfortunately,  try as hard as I could with an external  5
  387.     1/4" drive hooked up to my ST, I could not get it to read my disks.
  388.  
  389.     Therefore I selected the following method to emulate the 810 disk drive.
  390.     THIS IS DIFFERENT THAN THE METHOD USED IN XFORMER 1.2!!!!!
  391.  
  392.  
  393.                                  Page 6 
  394.  
  395.  
  396.  
  397.  
  398.     In this ARC file there is a file called DEMODISK.SD.  Notice that it  is
  399.     92160  bytes long,  exactly the number of bytes of storage on a  floppy.
  400.     The  .SD file is an exact bit image of a floppy disk.  All  720  sectors
  401.     were copied to the ST and stored in this file.
  402.  
  403.     What does this mean to you?  Well it means that instead of porting files
  404.     one by one to the ST,  you can port over entire disks! The disks must be
  405.     formatted in single density and unprotected,  but besides that, there is
  406.     no limit to what can be on the disk.  I have tested Xformer II with  DOS
  407.     2.0,  DOS 2.5, DOS 4.0, Sparta DOS 1.1, and MyDos 4.1 with full success.
  408.     All the other DOSes _should_ work assuming you configure them for an 810
  409.     drive _before_ porting the disk over.
  410.  
  411.     Now,  how  do you port a disk?  Most of you should be familiar with  the
  412.     Disk  Communicator  program  by  Robert Puff.  It  is  known  simply  as
  413.     DiskComm, and 3.2 is the latest version. Note that DC32.COM is supplied.
  414.     DiskComm is basically a disk scruncher and unscruncher.  It takes a disk
  415.     and compresses it into a single file,  which can be easily transfered by
  416.     modem to another computer, and uncompressed.
  417.  
  418.     Now,  boot up your favorite terminal software on your 8 bit  Atari,  and
  419.     boot up your favorite ST terminal software, set them both to XMODEM, and
  420.     port DC32.COM to your 8 bit. Even if you already have Diskcomm on your 8
  421.     bit port over this version!!!!!
  422.  
  423.     Now,  reboot the 8 bit computer and run Diskcomm.  It will allow you  to
  424.     set  the source and destination drives.  The SOURCE drive is  the  drive
  425.     which contains the disk to be ported. The DESTINATION drive is where you
  426.     will  insert a blank formatted disk,  to which the source disk will  get
  427.     written out as a file.
  428.  
  429.     When  this  is done,  boot up the  terminal  software  again,  and
  430.     transfer the disk file (should have a .DSC extender) to the ST.
  431.  
  432.     Now  run Xformer II and enter the Atari Configuration dialog box  again.
  433.     Click  on "Insert...",  then click on D1:,  and when the  file  selector
  434.     appears, select DEMODISK.SD. Now repeat this but select D2: as the drive
  435.     to  load.  What  you have just done is loaded the 2  virtual  Atari  810
  436.     drives that Xformer II emulates with 2 identical disks.
  437.  
  438.     Before you boot though,  you will want to copy Diskcomm into one of  the
  439.     virtual  810  drives.  To do this click on the  button  marked  "Utils".
  440.     Another dialog box will appear,  and click on the button marked "File to
  441.     D:".  This allows you to take a file off your ST disk and merge it  into
  442.     an .SD file, in effect, copying a file onto one of these 810 disk files.
  443.  
  444.     Ok,  you've  clicked on it,  so another file  selector  appears.  Select
  445.     DC32.COM  and the Xformer will copy the file from the ST disk  and  onto
  446.     the virtual D1: disk, stored in Xformer's memory.
  447.  
  448.     Now exit this and go up to "Xformer II" and select "Reboot".  Voila! The
  449.     Atari 800 boots.  If you had BASIC plugged IN,  you should see the  word
  450.     READY on the screen.  If so, type in DOS and press RETURN. Atari DOS 2.5
  451.     will load.
  452.  
  453.     I  assume that most people are familiar enough with DOS that they  don't
  454.     need instructions.  If you do,  the documentation I supply to registered
  455.     users will among other things, explain Atari DOS.
  456.  
  457.  
  458.  
  459.                                  Page 7 
  460.  
  461.  
  462.  
  463.  
  464.     From DOS,  format D2:,  then write out the DOS files to it. What you are
  465.     doing is creating a blank DOS 2.5 disk.
  466.  
  467.     Now  press  F5  to  exit the emulation,  and  go  back  into  the  Atari
  468.     Configuration  box.  Click on "Eject..." and select D1:.  When the  file
  469.     selector  appears,  click on DEMODISK.SD again.  What you've done is  to
  470.     save an updated version of DEMODISK to your ST disk,  which now contains
  471.     Diskcomm 3.2 on it.  Similarly,  save out D2:  to a file called DOS25.SD
  472.     (or whatever name you choose). Use this file as the seed for all further
  473.     .SD files that you create.
  474.  
  475.     Now,  go to "Utils" again, and copy the .DSC file you created earlier on
  476.     your 8 bit to D2:  (the blank DOS 2.5 disk).  Hopefully it will fit.  If
  477.     not, reformat D2: and don't write DOS to it.
  478.  
  479.     Now,  make sure that Atari BASIC is OUT, and "Reboot" the Atari 800. Run
  480.     DiskComm and choose D2:  as the source and D1:  as the destination. What
  481.     you are going to do is uncompress the .DSC file now on D2:  and put  the
  482.     uncompressed disk image on D1:.  Yes, this will overwrite the files from
  483.     DEMODISK, but don't worry, it is safely stored on your ST disk.
  484.  
  485.     Now start DiskComm and watch the sectors fly.  In a few minutes, it will
  486.     be  finished.  Now press F5 again,  click on "Eject...",  and save  this
  487.     newly created D1 to a new .SD file.  For example, if you ported over the
  488.     latest Analog monthly disk, you may want to call the file ANLG0788.SD.
  489.  
  490.     Reboot the Atari 800 again and the new disk will boot.
  491.  
  492.     SOUND COMPLICATED?!?!?!?!?!?!?!?!?!?!?!?!!?
  493.  
  494.     It isn't really. If you think of the 2 virtual disk drives in Xformer II
  495.     as  2  810 disk drives hooked up to an Atari 800,  you see  that  you're
  496.     doing  nothing more than creating and copying files around on a  2  disk
  497.     drive system.
  498.  
  499.     Oh,  did  I mention the Disk I/O option?  This allows you turn  off  the
  500.     "beep  beep  beep"  sound  of  the disk drive  and  just  do  fast  disk
  501.     emulation.  Useful  when running DiskComm but you may wish to  keep  the
  502.     sound for old time's sake.
  503.  
  504.     Enough "Now"s!
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.                                  Page 8 
  526.  
  527.  
  528.  
  529.  
  530.                                   Part V
  531.                                   ------
  532.  
  533.     Well,  5  months after getting the first signs of life out of  Commodore
  534.     Basic running under C64 emulation, Commodore Business Machines has still
  535.     to return a single phone call of mine. Whenever I phone back, I'm put on
  536.     hold,  transfered,  asked for my name and number,  and goodbye  Charlie!
  537.     Obviously,  Commodore  has  not  learned how _not_  to  practise  public
  538.     relations.  At  least  with  Apple  I got  as  far  as  getting  several
  539.     "NO!!!!!!"s when I suggested that they licence their ROMs to me for  use
  540.     with Xformer.
  541.  
  542.     So, since neither one of those companies wishes to talk, perhaps someone
  543.     can  guide me to a manufacturer of clone machines,  or  better  yet,  to
  544.     someone  that  has written compatible versions of either  the  Apple  R]R[
  545.     operating  system,  or  the Commodore 64 OS.  I believe that  both  such
  546.     beasts exist,  (definately Apple clone ROMs) but I am unable to actually
  547.     find  a _legitemate_ manufacturer.  Anyone  with  information,  _please_
  548.     forward  it to me.  The day I get the clone code is the day  Xformer  II
  549.     goes up with the Apple R]R[ and/or C64 options enabled.
  550.  
  551.     Sorry  folks,  short of rewriting the Apple and C64 OS  code  myself,  I
  552.     cannot enable those two options.  It's too bad that Apple and  Commodore
  553.     have  decided to be so protective of their 'precious' ROMs.  It is  code
  554.     that is now 5 or 10 years old,  obsolete,  and wouldn't hurt their sales
  555.     whatsoever.  It could only help boost interest in their machines and the
  556.     software.  But I guess the only thing they'll listen to is the sound  of
  557.     cash registers.
  558.  
  559.     J.  Andrzej  Wrotniak said it best in his latest Current  Notes  article
  560.     (June 1988  Vol. 8 No. 5  page 38) when he was talking about Apple suing
  561.     everybody left and right over the Mac interface (which was developed  in
  562.     the 70's by XEROX,  and stolen by Apple).  He said, "the next thing they
  563.     may  want  to  do is to claim rights to the  rectangular  shape  of  the
  564.     computer screen." C'mon all you computer companies,  lighten up and talk
  565.     to me!
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.                                  Page 9 
  592.  
  593.  
  594.  
  595.  
  596.                                  Part VI
  597.                                  -------
  598.  
  599.     With the release of ST Xformer II, I hope to hear from many different ST
  600.     users  from all over the U.S.  and Canada.  Work on ST Xformer  II  will
  601.     continue  on  through  the summer,  (pausing for the  long  weekends  of
  602.     course!)  and  an update version with the  missing  Atari  functionality
  603.     should  be out by August.  Also,  if I can get somewhere  regarding  the
  604.     Apple and C64 ROM issues, those features will be made available also.
  605.  
  606.     I've  already had several requests to make Xformer II 520ST  compatible.
  607.     This would require getting rid of all the GEM support,  and some of  the
  608.     functionality,  but I do believe a version of an Atari 800 emulator  can
  609.     be made for 512K machines without any loss of speed or compatibility. If
  610.     I succeed,  I'll make it available on all the same places Xformer II  is
  611.     now on.
  612.  
  613.     As  I already mentioned,  I still have to put in the bank select  memory
  614.     emulation for real 800XL and 130XE support.  That should be in soon, and
  615.     registered users will receive it on their update disks.
  616.  
  617.     Also,  I  need to get some feedback from users regarding  what  software
  618.     runs,  how well,  what doesn't run,  and how bad.  Also, any suggestions
  619.     regarding  the user interface or features that could be put in  (have  I
  620.     forgotten to emulate something?) are most welcome!
  621.  
  622.     I would also be very interested in porting this program over to the  Mac
  623.     II  and  the Amiga.  From what I've heard of the C64  emulators  on  the
  624.     Amiga,  they're far slower than the Xformer,  (probably because  they're
  625.     using the standard p-code interpreter code used in Xformer 1.2). I think
  626.     Xformer II could blow them out of the water.  And on the Mac  II,  well,
  627.     multiply the speed of Xformer by about 5, and you get the speed it would
  628.     run  at on a Mac II.  Anyone interested,  simply send a Mac II or  Amiga
  629.     2000  to  the same address already given above,  and I'll  gladly  start
  630.     porting  the  code  over.  Both  Commodore and Apple  seem  to  have  no
  631.     complaints about emulators running on _their_ machines.  Also, if anyone
  632.     wants to send me a Mega ST 2 or 4,  I'll be glad to add support for  all
  633.     drives D1:  thru D8:, double and single density. (Maybe call it the Mega
  634.     Xformer??) Unfortunately,  on a 1 Meg machine,  (with which Xformers are
  635.     developed  on) there is only enough memory to support  D1:  and  D2:  in
  636.     single density.
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.                                  Page 10 
  658.  
  659.  
  660.  
  661.  
  662.                                  Part VII
  663.                                  --------
  664.  
  665.     This  is an open invitation to all Atari 8 bit programmers to try  their
  666.     software on the Xformer and see how it runs.  If it runs well, advertize
  667.     that  fact.   Let  people  know  that  your  software  is  "Xformer   II
  668.     Compatible".
  669.  
  670.     If it doesn't run well,  but it is a small problem to fix, please take a
  671.     few minutes to adjust your software to make it Xformer Compatible. Since
  672.     most  of  the  incompatibilities will be in the area  of  speed,  it  is
  673.     usually  simply  a matter of adjusting your timing loops.  To  help  you
  674.     detect  the Xformer,  I have modified hardware register $D015 to  always
  675.     return the value $C0 instead of $0F.  This is your way of detecting  the
  676.     Xformer at run-time, so that proper adjustments can  be made.
  677.  
  678.     If your software does not run at all, but you are interested in allowing
  679.     ST users run your software,  please send me a copy of your software, and
  680.     if possible, a listing, or simply a list of possible trouble points, and
  681.     I'll try to fix the problem in updates of Xformer II.
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.                                  Page 11 
  724.  
  725.  
  726.  
  727.                                  Part VIII
  728.                                  ---------
  729.  
  730.     There  is a section in Xformer II called "Scratch 'n Sniff".  This is  a
  731.     billboard on which Atari related products or services can be advertized.
  732.     It  is still not too late to place your ad.  I charge reasonable  rates.
  733.     Ask the current bunch of paid advertizers!
  734.  
  735.     Also, any sysops of Atari ST bulletin boards who would like to advertize
  736.     their  BBSs  should send me a letter with  the  important  info.  Again,
  737.     reasonable rates will be charged.
  738.  
  739.     User groups wishing to advertize themselves should send me their 3  most
  740.     recent newsletters and their ad. No charge.
  741.  
  742.     Anyone  who gets a chance to try Xformer II on any of the 14 or  16  MHz
  743.     accelerator boards,  please let me know if it runs,  and if so, how much
  744.     faster.
  745.  
  746.     I  have to acknowledge some of the people whose ideas made Xformer II  a
  747.     reality.  First  there's Charles Smeton,  who soon after the release  of
  748.     Xformer  1.1 pointed out to me on GEnie a code optimization that  I  now
  749.     use in Xformer II.  Just before that, David Small, at a show in Toronto,
  750.     scribbled  down his ideas on speeding up Xformer which later turned  out
  751.     to  be  the  foundation  of  Xformer  II.  Actually,  Jan  Grey,  fellow
  752.     University of Waterloo student,  ST owner,  and Microsoft employee,  had
  753.     the  same idea about 6 months earlier,  but (sorry Jan) I though he  was
  754.     kidding  when showed me the code!  Fortunately after I  refined  David's
  755.     idea into real code,  Jan came up with the ultimate speed hack.  And  of
  756.     course,  there's Bill Teal,  who's trying to do the same thing I am  but
  757.     for a different CPU (and doing it better!), who pointed out a few things
  758.     I could do, and did, to make Xformer II faster. The final result, as you
  759.     already know, was a 100% increase in speed over the previous Xformers.
  760.  
  761.     Then  of course,  there's the people who's comments were  so  depressing
  762.     that  I felt like giving up on Xformer II altogether.  You know who  you
  763.     are,  and  I hope you've changed your minds about the idea  of  software
  764.     emulators, since you not only put down Xformer but PC Ditto and the CP/M
  765.     emulator  as  well.  But  one thorn that still sticks  in  my  side  are
  766.     comments made by various members of COMPUTE magazine. May you fold soon!
  767.     Enough said.
  768.  
  769.     Also, in the works: ST Xformer III 6502 emulator and compiler.  Does all
  770.     the things  this one can with  one small difference.  Programs are first
  771.     compiled into native 68000 code, _then_ executed. This should allow most
  772.     Atari 800 programs to run at least 2 or 3 times their normal speed!
  773.  
  774.     Finally, I'd just like to remind everyone once again that the ST Xformer
  775.     II _is_ a shareware product.  It is _not_ public domain.  Therefore,  if
  776.     you use it,  please pay for it.  Out of the $15 you send, almost half of
  777.     that will go back to you in the form of the documentation,  update disk,
  778.     and of course,  postage.  I think I'm making a very fair deal  here,  so
  779.     let's  see  shareware work.  I don't want to become another one  of  the
  780.     already  too  large  group of ST programmers who  put  out  a  shareware
  781.     product, only to see it be used by everyone and paid for by no one.
  782.  
  783.     BIX, DELPHI, GENIE: DAREKM    Compuserve: 73657,2714
  784.     Xformer Hotline: (519)-747-0386
  785.  
  786.     Send your registration money ($15 US or $20 Canadian) to:
  787.     310-D Bluevale St. N., Waterloo, Ontario, CANADA N2J 4G3
  788.  
  789.